home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 301-325 / disk_319 / cnewssrc / cnews.orig.lzh / man / relaynew.man < prev    next >
Text File  |  1989-06-28  |  9KB  |  199 lines
  1.  
  2.  
  3.  
  4.      RRRREEEELLLLAAAAYYYYNNNNEEEEWWWWSSSS((((8888))))          CCCC NNNNeeeewwwwssss ((((22228888 MMMMaaaayyyy 1111999988889999))))           RRRREEEELLLLAAAAYYYYNNNNEEEEWWWWSSSS((((8888))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           relaynews - store and forward netnews articles
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           rrrreeeellllaaaayyyynnnneeeewwwwssss [ ----iiiinnnnrrrrssss ] [ ----dddd ffffhhhhllllmmmmtttt ] [ ----xxxx excluded-site ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           _R_e_l_a_y_n_e_w_s installs locally and broadcasts (network) news
  16.           articles read from its standard input.  Typically the
  17.           articles will be in a batch (see _n_e_w_s(5)), which may _n_o_t be
  18.           compressed (see _c_o_m_p_r_e_s_s(1)).  Articles are usually queued
  19.           for transmission to one's netnews neighbours via
  20.           _n_e_w_s_b_a_t_c_h(8) and thence via _u_u_x(1) or _m_a_i_l(1).
  21.  
  22.           ----dddd turns on debugging of ffffiling, hhhheaders, llllocking, mmmmatching,
  23.           ttttransmission.  ----rrrr redirects stdout and stderr to
  24.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////lllloooogggg and ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////eeeerrrrrrrrlllloooogggg.  ----iiii redirects
  25.           stdout only to ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////lllloooogggg.  ----nnnn enables ``NNTP mode''
  26.           in which history entries are generated as articles are
  27.           rejected.  ----ssss makes discarding an article a serious matter.
  28.           ----xxxx excludes _e_x_c_l_u_d_e_d-_s_i_t_e from the list of netnews
  29.           neighbours to receive article(s).
  30.  
  31.           _C_o_n_t_r_o_l _m_e_s_s_a_g_e_s, recognised by their CCCCoooonnnnttttrrrroooollll:::: headers (or
  32.           ffffoooorrrr bbbbaaaacccckkkkwwwwaaaarrrrdddd ccccoooommmmppppaaaattttiiiibbbbiiiilllliiiittttyyyy OOOONNNNLLLLYYYY a NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: header
  33.           containing a single newsgroup ending in ....ccccttttllll), are filed
  34.           under the ccccoooonnnnttttrrrroooollll pseudo-group only, but are forwarded as
  35.           usual, by examining their NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: and DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn::::
  36.           headers.  Note that posting to the ccccoooonnnnttttrrrroooollll pseudo-group will
  37.           not cause a message to be treated as a control message;
  38.           ccccoooonnnnttttrrrroooollll is not a real newsgroup.
  39.  
  40.           Articles which contain no locally-known (to the _a_c_t_i_v_e file)
  41.           newsgroups yet accepted by the local subscription list are
  42.           filed exactly once, in the jjjjuuuunnnnkkkk pseudo-group, and forwarded
  43.           as usual.  In particular, if all newsgroups in the article
  44.           are refused by the local subscription list or are refused by
  45.           an xxxx in _a_c_t_i_v_e file entries, then the article will be
  46.           _d_i_s_c_a_r_d_e_d and not filed in jjjjuuuunnnnkkkk.
  47.  
  48.           Locally-generated articles need not be permitted by the
  49.           local subscription list but are otherwise processed
  50.           normally; this is for backward compatibility and perhaps to
  51.           keep the local subscription list short by not requiring
  52.           ggggeeeennnneeeerrrraaaallll and the like to be named.
  53.  
  54.      FFFFIIIILLLLEEEESSSS
  55.           ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss     netnews article tree
  56.           ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss////ccccoooommmmpppp////uuuunnnniiiixxxx////wwwwiiiizzzzaaaarrrrddddssss
  57.                               example newsgroup directory (for
  58.                               ccccoooommmmpppp....uuuunnnniiiixxxx....wwwwiiiizzzzaaaarrrrddddssss)
  59.           ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss////oooouuuutttt....ggggooooiiiinnnngggg////_s_y_s_t_e_m////ttttooooggggoooo
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 6/29/89)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RRRREEEELLLLAAAAYYYYNNNNEEEEWWWWSSSS((((8888))))          CCCC NNNNeeeewwwwssss ((((22228888 MMMMaaaayyyy 1111999988889999))))           RRRREEEELLLLAAAAYYYYNNNNEEEEWWWWSSSS((((8888))))
  71.  
  72.  
  73.  
  74.                               default ssssyyyyssss file FFFF, ffff and IIII flags
  75.                               filename
  76.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////ssssyyyyssss   determines who receives broadcast
  77.                               netnews articles, which ones, and how
  78.                               they are to be sent articles
  79.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////aaaaccccttttiiiivvvveeee
  80.                               contains locally-legal newsgroups and
  81.                               (un)moderated flag
  82.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////hhhhiiiissssttttoooorrrryyyy
  83.                               record of articles received
  84.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////hhhhiiiissssttttoooorrrryyyy....{{{{ddddiiiirrrr,,,,ppppaaaagggg}}}}
  85.                               _d_b_m(3) index into hhhhiiiissssttttoooorrrryyyy
  86.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////wwwwhhhhooooaaaammmmiiii
  87.                               if present, contains news system's site
  88.                               name, overriding any other host names
  89.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////lllloooogggg   log of incoming articles
  90.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////eeeerrrrrrrrlllloooogggg
  91.                               log of errors, should be empty
  92.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////bbbbiiiinnnn   system-specific directory of programs to
  93.                               override ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn and its
  94.                               subdirectories
  95.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ccccttttllll
  96.                               common directory of programs to
  97.                               implement control messages
  98.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////rrrreeeellllaaaayyyy////rrrreeeellllaaaayyyynnnneeeewwwwssss
  99.                               the lean, mean news-relayin' machine
  100.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////nnnneeeewwwwssssrrrreeeeppppllllyyyy
  101.                               generates a return address from article
  102.                               headers
  103.  
  104.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  105.           _c_o_m_p_r_e_s_s(1), _m_a_i_l(1), _u_u_x(1), _d_b_m(3), _n_e_w_s(5), _n_e_w_s_b_a_t_c_h(8)
  106.           ARPA Internet RFCs 1036 and 850
  107.  
  108.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  109.           Usually found in ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssss////eeeerrrrrrrrlllloooogggg.
  110.           _R_e_l_a_y_n_e_w_s's exit status is a bit vector of status bits; see
  111.           nnnneeeewwwwssss////iiiinnnncccclllluuuuddddeeee////nnnneeeewwwwssss....hhhh for the bit definitions.
  112.  
  113.      HHHHIIIISSSSTTTTOOOORRRRYYYY
  114.           Written by Geoff Collyer at the University of Toronto as
  115.           part of the C news project.
  116.  
  117.      BBBBUUUUGGGGSSSS
  118.           An article with a header that does not fit entirely in a
  119.           static buffer and on a machine without real links (e.g.
  120.           something like Eunice but on a PDP-11) will be filed
  121.           incorrectly: any symbolic links under /usr/spool/news will
  122.           point at a non-existent filename.
  123.           A control message which cannot be filed in the ccccoooonnnnttttrrrroooollll
  124.           pseudo-group and which cannot be filed in the jjjjuuuunnnnkkkk pseudo-
  125.           group because jjjjuuuunnnnkkkk is not in the _a_c_t_i_v_e file will generate
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 6/29/89)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      RRRREEEELLLLAAAAYYYYNNNNEEEEWWWWSSSS((((8888))))          CCCC NNNNeeeewwwwssss ((((22228888 MMMMaaaayyyy 1111999988889999))))           RRRREEEELLLLAAAAYYYYNNNNEEEEWWWWSSSS((((8888))))
  137.  
  138.  
  139.  
  140.           an error message which refers to the groups in its
  141.           NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: header instead of referring to the ccccoooonnnnttttrrrroooollll
  142.           pseudo-group.
  143.           _R_e_l_a_y_n_e_w_s could run faster in some circumstances and would
  144.           be simpler if _C_o_n_t_r_o_l: were required to be the first header,
  145.           if present, and if _N_e_w_s_g_r_o_u_p_s: were required to be the next.
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 6/29/89)
  196.  
  197.  
  198.  
  199.